home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / ra / dsort275.zip / DSORT.DOC < prev    next >
Text File  |  1992-08-19  |  8KB  |  199 lines
  1.                        ▀▀▀▀▀▀▀▀ ▀▀▀▀▀▀   ▀▀▀▀▀▀▀
  2.                           ▀▀    ▀▀   ▀▀     ▀▀▀
  3.                           ▀▀    ▀▀   ▀▀▀   ▀▀▀
  4.                           ▀▀    ▀▀   ▀▀   ▀▀▀
  5.                           ▀▀    ▀▀▀▀▀▀   ▀▀▀▀▀▀▀
  6.  
  7.                 [The DeAdZoNe Utilities for RemoteAccess]
  8.  
  9.    ┌─────────────────────────────────────────────────────────────────┐
  10.    │                               D-SoRt                            │
  11.    │                                                                 │
  12.    │                 FILES.BBS sorter for RemoteAccess               │
  13.    │                                                                 │
  14.    │                      Version 2.75   August 21, 1992             │
  15.    │                                                                 │
  16.    │               (C) Copyright Victor Magdic 1991,1992             │
  17.    │                                                                 │
  18.    │                        All Rights Reserved                      │
  19.    └─────────────────────────────────────────────────────────────────┘
  20.  
  21.  
  22. Description
  23. ═══════════
  24.  
  25.  D-SoRt is a program for RemoteAccess which is designed to easily and
  26.  quickly sort your FILES.BBS files in alphabetical order.  If you have
  27.  certain file areas which do not want sorted, D-SoRt can be configured
  28.  to skip them.
  29.  
  30.  If you have header lines at the top of your FILES.BBS, which provide
  31.  the user with information about the files etc., D-SoRt will not attempt
  32.  to sort them, but will leave them intact. (Please read the section
  33.  labelled "Header Lines" below.)
  34.  
  35.  Note: Please read the "Considerations" section below, before attempting
  36.        to use D-SoRt.
  37.  
  38.  
  39. How much does it cost?
  40. ══════════════════════
  41.  
  42.   This utility is FREE!  If you like it you can continue to use it
  43.   for as long as you like free of charge!
  44.  
  45.   If you do decide to use it, I would be excited to hear from you !!
  46.   I encourage you to send me a postcard at the address listed below (see
  47.   the end of this text file). It will cost you practically nothing, and
  48.   will let me know you're enjoying the program. It will also give me
  49.   incentive to keep improving the program and make it even better!
  50.  
  51.  
  52. How To Use D-SoRt
  53. ═════════════════
  54.  
  55.  To sort your file areas simply run DSORT.EXE. One command line switch
  56.  is supported:
  57.  
  58.        DSORT /N      Suppresses the creation of a backup file of your
  59.                      FILES.BBS (called FILES.BAK) before sorting begins.
  60.                      Normally D-SoRt will make a backup of FILES.BBS,
  61.                      this switch will turn that feature off.
  62.  
  63.  If you want to configure D-SoRt to exclude certain file areas from
  64.  being sorted, run it with the /C switch. This will bring up the built
  65.  in configuration "editor", which you can use to choose the file areas
  66.  you want sorted. The editor is self-explanatory.
  67.  
  68.        DSORT /C
  69.  
  70.  Note: When you run D-SoRt with the /C option, it creates a file called
  71.        DSORT.CTL in the main RA directory, which it uses to keep track of
  72.        the file areas which will be sorted. DO NOT ATTEMPT to edit this
  73.        file yourself. If you want to modify DSORT.CTL do so by invoking
  74.        the configuration editor with the /C switch.
  75.  
  76.  
  77. Location of Files
  78. ═════════════════
  79.  
  80.  If your RA environment variable is set then D-SoRt can be run from
  81.  anywhere on your hard drive. If the RA environment variable is not set
  82.  then you must run D-SoRt from the main RA directory (i.e. the directory
  83.  where CONFIG.RA is located).  For more information on setting the RA
  84.  environment variable, consult the RA docs.
  85.  
  86.  
  87. Header Lines
  88. ════════════
  89.  
  90.  Many sysops like to put header lines at the top of their FILES.BBS,
  91.  which provide some kind of information to the user about the files in
  92.  that particular file area (e.g. download restrictions or warnings etc).
  93.  Most sort utilities will not recognize these header lines and will be
  94.  unable to distinguish them from actual file descriptions. If you try to
  95.  run them you will get header lines mixed up with file descriptions - one
  96.  ugly jumbled mess!
  97.  
  98.  D-SoRt does away with these problems by *recognizing* such header lines,
  99.  and not disturbing them. D-SoRt will handle up to 50 header lines per
  100.  FILES.BBS -which is roughly equal to two screenfuls of "header" information.
  101.  This should be adequate for most purposes. If you require more, let me know
  102.  and I will gladly modify D-SoRt to accomodate your needs.
  103.  
  104.  D-SoRt determines whether a line is "header" information, or whether it
  105.  is a valid filename/description by using the following criteria:
  106.  
  107.        The line is assumed to be a header line if it starts with:
  108.  
  109.                     a space; or
  110.                     a dash; or
  111.                     is a blank line
  112.  
  113.        This is the same way that RemoteAccess determines if a line is a
  114.        "header" so there should not be any problems.
  115.  
  116.  NOTE: It is not recommended that you use D-SoRt on file areas which
  117.        have "header" lines somewhere in the middle or end of the FILES.BBS
  118.        (that is, somewhere in between your file descriptions), because
  119.        they will be moved to the top. The best thing to do if you have
  120.        file areas like this is to simply configure D-SoRt to skip them
  121.        when sorting (use the /C switch to invoke the configuration menu).
  122.  
  123.  
  124. Considerations
  125. ══════════════
  126.  
  127.  The following considerations apply when using D-SoRt v2.75,
  128.  
  129.   * D-SoRt will handle a maximum line length of 255 characters. If your
  130.     file descriptions exceed this length they will be truncated to 255
  131.     characters. This should not be a problem under normal circumstances
  132.     since RA itself only recognizes up to 255 characters per file description.
  133.  
  134.   * D-SoRt will handle a maximum of 1000 file entries in each FILES.BBS.
  135.     If you have more than 1000, that particular FILES.BBS will not be
  136.     sorted and D-SoRt will abort with an error message. (Note: even
  137.     though an error message is generated, no modifications will be made
  138.     to the FILES.BBS, so nothing will be "damaged".)
  139.  
  140.   * D-SoRt will accomodate up to 50 lines of header information per
  141.     FILES.BBS. Anything past this point will be ignored. (See the
  142.     section on "Header Lines" above.)
  143.  
  144.  
  145. Legal Stuff and Disclaimer
  146. ══════════════════════════
  147.  
  148.   "D-SoRt" refers to the executables and documentation in the original
  149.   distribution archive. D-SoRt is copyrighted material by the author,
  150.   Victor Magdic. All rights are reserved.
  151.  
  152.   The program is provided "as is", without warranty or guarantee of any kind,
  153.   either expressed or implied, as to its quality or performance. The author,
  154.   will not be held liable to you or anyone for any direct, indirect, incidental
  155.   or consequential damages, including but not limited to any lost profits, or
  156.   lost savings which may result from the use or inability to use this program.
  157.  
  158.   The author is in no way obligated to provide future versions of this
  159.   software.
  160.  
  161.   Your use of the program constitutes your agreement to these terms and to
  162.   this disclaimer and your release of the author from any form of liability
  163.   or litigation.
  164.  
  165.   All mentioned products are copyrighted by and trademarks of their respective
  166.   holders.
  167.  
  168.  
  169. Credits
  170. ═══════
  171.  
  172.   Thanks to James FitzGibbon for helping me beta test D-SoRt.
  173.  
  174.  
  175. Suggestions always welcome!
  176. ═══════════════════════════
  177.  
  178.   If you have any suggestions for improvement or wish to report any bugs,
  179.   you can reach me through my BBS:
  180.  
  181.  
  182.                The DeAdZoNe          ...Experience the Difference!
  183.                SysOp: Victor Magdic
  184.                (416) 507-2159
  185.                FidoNet: 1:259/427
  186.                TeleNet Canada: 20:22/4
  187.                F-Net: 110:112/1
  188.  
  189.  
  190.   or by writing to:
  191.  
  192.               Victor Magdic
  193.               424 Camden Circle
  194.               Mississauga, Ontario
  195.               L4Z 2P4
  196.               CANADA
  197.  
  198. ══════════════════════════════════════════════════════════════════════ end
  199.